# Graphsignal

本页面介绍如何使用 [Graphsignal](https://app.graphsignal.com) 来跟踪和监控 LangChain。Graphsignal 可以全面查看您的应用程序。它提供了链路和工具的延迟分解、带有完整上下文的异常、数据监控、计算/GPU 利用率、OpenAI 成本分析等功能。

## 安装和设置

- 使用 `pip install graphsignal` 安装 Python 库
- 在 [此处](https://graphsignal.com) 创建免费的 Graphsignal 账户
- 获取 API 密钥并将其设置为环境变量（`GRAPHSIGNAL_API_KEY`）

## 跟踪和监控

Graphsignal 会自动对链路进行仪器化和启动跟踪和监控。然后可以在 [Graphsignal 仪表板](https://app.graphsignal.com) 中查看跟踪和指标。

通过提供部署名称来初始化跟踪器：

```python
import graphsignal

graphsignal.configure(deployment='my-langchain-app-prod')
```

要额外跟踪任何函数或代码，可以使用装饰器或上下文管理器：

```python
@graphsignal.trace_function
def handle_request():    
    chain.run("some initial text")
```

```python
with graphsignal.start_trace('my-chain'):
    chain.run("some initial text")
```

可以选择启用性能分析，以记录每个跟踪的函数级统计信息。

```python
with graphsignal.start_trace(
        'my-chain', options=graphsignal.TraceOptions(enable_profiling=True)):
    chain.run("some initial text")
```

请参阅 [快速入门](https://graphsignal.com/docs/guides/quick-start/) 指南以获取完整的设置说明。
